feat: Add consolidation to cbmigrations #51
Open
lmajano wants to merge 14 commits into
Open
Conversation
… scaffolding Generalizes the CF-prefixed config lookup methods and adds a shared isBoxLangProject() detection (running BoxLang server, or box.json "language": "boxlang") so migrate init, migrate create, and migrate seed create can scaffold BoxLang-flavored files via an explicit --boxlang flag or auto-detection.
Adds doc comments to every method in BaseMigrationCommand.cfc, ModuleConfig.cfc's configure(), and seed/run.cfc's completeSeedNames(), the only methods in the module lacking documentation.
Adds a dedicated BoxLang Support section covering .bxmigrations.json, .bx file scaffolding, and the auto-detection/--boxlang override behavior, and cross-references it from the Setup section.
The Usage section was missing manager, verbose, seed, force, and open flags for most commands even though they were already implemented. Each command's documented signature now matches its run() signature.
- remove old .hint that are not required anymore and produce noise
…d of cfmigrations to provide abstractions.
lmajano
changed the title
bdw429s
approved these changes
Jun 16, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
This PR modernizes commandbox-migrations with full BoxLang support, renames the config file from
.cfmigrations.jsonto.cbmigrations.json, adds comprehensive documentation, and introduces AI agent integration with 45+ domain-specific skills. This is the first part, then the second part is renamingcfmigrationsmodules to thecbMigrationsmodule.Features
🚀 BoxLang Support
MigrationBX.txtandseedBX.txtfor BoxLang-flavored.bxmigrations and seedsisBoxLangProject()detects BoxLang projects via the running CommandBox server's engine orbox.jsonlanguagekeymigrate createandmigrate seed createautomatically select the correct template (.cfcvs.bx) based on project type.bxlint.jsonconfiguration for.bxtemplate validation.cfmigrations.json→.cbmigrations.json).cbmigrations.json, abstracting away the CF-specific naming.cfmigrations.jsonis still read if.cbmigrations.jsondoesn't exist.cbmigrations.json→.cfmigrations.json→box.jsoncfmigrationskey (deprecated, auto-converted)📖 Documentation & Code Quality
run()method now has JavaDoc-style param descriptionsBaseMigrationCommand.cfc(setup(),installDatasource(),setMigrationPath(),checkForInstalledMigrationTable(), etc.) now have full JavaDoc comments.cfcand.bxfiles🤖 AI Agent Integration
AGENTS.md: Comprehensive project guidelines covering code style (Ortus standards), architecture, build/test commands, conventions, and a full skills reference tableskills-lock.json: Tracks installed skill versions🧹 Cleanup
.hintfiles that produced unnecessary noisebox.jsonmetadata andModuleConfig.cfcwith improved structureFiles Changed
23 files changed — +999 / -170 lines